import { get, post, postWithQueryParams } from "@/api/request";

/**
 * 文件上传控制器 / 文件上传控制器添加
 * @param {object} data
 * @param {array<附件传输实体>} [data.attachmentList] 附件
 * @param {string} [data.fileName] 文件名称
 * @param {number} [data.menuId] 菜单id
 * @param {number} [data.projectPlanningId] 项目规划id
 * @param {string} [data.remarks] 备注
 * @param {string} [data.uploadDate] 上传日期 YYYY-MM-DD HH:mm:ss
 * @param {import("axios").AxiosRequestConfig} [config]
 * @returns {Promise<FileUpload页面展示实体>}
 * @author 肖玮
 */
export function fileUploadAdd(data, config) {
  return post("/fileUpload/add", data, config);
}

/**
 * 文件上传控制器 / 文件上传控制器删除
 * @param {object} params
 * @param {object} data
 * @param {number} params.id ID
 * @param {import("axios").AxiosRequestConfig} [config]
 * @returns {Promise<FileUpload页面展示实体>}
 * @author 肖玮
 */
export function fileUploadDelete(params, data, config) {
  return postWithQueryParams("/fileUpload/delete", params, data, config);
}

/**
 * 文件上传控制器 / 文件上传控制器查询详情
 * @param {object} params
 * @param {number} params.id ID
 * @param {import("axios").AxiosRequestConfig} [config]
 * @returns {Promise<FileUpload页面展示实体>}
 * @author 肖玮
 */
export function fileUploadDetail(params, config) {
  return get("/fileUpload/detail", params, config);
}

/**
 * 文件上传控制器 / 文件上传控制器导出
 * @param {object} data
 * @param {string} [data.endUploadDate] 上传结束日期 YYYY-MM-DD HH:mm:ss
 * @param {string} [data.fileName] 文件名称
 * @param {number} [data.menuId] 菜单id
 * @param {string} [data.projectName] 项目名称
 * @param {string} [data.startUploadDate] 上传开始日期 YYYY-MM-DD HH:mm:ss
 * @param {import("axios").AxiosRequestConfig} [config]
 * @returns {Promise}
 * @author 肖玮
 */
export function fileUploadExport(data, config) {
  return post("/fileUpload/export", data, config);
}

/**
 * 文件上传控制器 / 文件上传控制器分页查询
 * @param {object} data
 * @param {string} [data.endUploadDate] 上传结束日期 YYYY-MM-DD HH:mm:ss
 * @param {string} [data.fileName] 文件名称
 * @param {number} [data.length] 分页大小
 * @param {number} [data.menuId] 菜单id
 * @param {number} [data.orderAsc] 排序方向
 * @param {string} [data.orderColum] 排序字段
 * @param {number} [data.pageIndex] 分页下标
 * @param {string} [data.projectName] 项目名称
 * @param {number} [data.start] 查询记录起始下标
 * @param {string} [data.startUploadDate] 上传开始日期 YYYY-MM-DD HH:mm:ss
 * @param {import("axios").AxiosRequestConfig} [config]
 * @returns {Promise<分页返回实体<FileUpload页面展示实体>>}
 * @author 肖玮
 */
export function fileUploadPage(data, config) {
  return post("/fileUpload/page", data, config);
}

/**
 * 文件上传控制器 / 文件上传控制器更新
 * @param {object} data
 * @param {array<附件传输实体>} [data.attachmentList] 附件
 * @param {string} [data.fileName] 文件名称
 * @param {number} [data.id] id
 * @param {number} [data.menuId] 菜单id
 * @param {number} [data.projectPlanningId] 项目规划id
 * @param {string} [data.remarks] 备注
 * @param {string} [data.uploadDate] 上传日期 YYYY-MM-DD HH:mm:ss
 * @param {import("axios").AxiosRequestConfig} [config]
 * @returns {Promise<FileUpload页面展示实体>}
 * @author 肖玮
 */
export function fileUploadUpdate(data, config) {
  return post("/fileUpload/update", data, config);
}

/**
 * @template T
 * @typedef {Object} 分页返回实体
 * @property {T[]} content - 内容
 * @property {number} elementsNo
 * @property {number} limit
 * @property {number} number
 * @property {number} totalElements
 * @property {number} totalPages
 * @description 分页返回实体
 */

/**
 * @typedef {object} 附件传输实体 附件传输实体
 * @property {string} attUrl 附件url
 * @property {number} directoryId 目录id
 * @property {number} id 附件id
 * @property {string} originalName 原始文件名
 * @description 附件传输实体
 */

/**
 * @typedef {object} FileUpload页面展示实体 文件上传页面展示实体
 * @property {string} createTime 创建时间
 * @property {string} createUser 创建用户
 * @property {string} createUserName 编制人
 * @property {number} departmentId 编制部门
 * @property {string} departmentName 编制部门名称
 * @property {string} fileName 文件名称
 * @property {number} id
 * @property {boolean} isEdit 是否可以编辑
 * @property {number} menuId 菜单id
 * @property {string} projectName 项目名称
 * @property {number} projectPlanningId 项目规划id
 * @property {string} remarks 备注
 * @property {string} uploadDate 上传日期
 * @description 文件上传页面展示实体
 */
